home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / faq / sci / news_ans / guidelin next >
Internet Message Format  |  1994-03-29  |  37KB
  1. Path: bloom-beacon.mit.edu!senator-bedfellow.mit.edu!cam.ov.com!jik
  2. From: jik@cam.ov.com (Jonathan I. Kamens)
  3. Newsgroups: news.answers,alt.answers,comp.answers,de.answers,misc.answers,rec.answers,sci.answers,soc.answers,talk.answers
  4. Subject: *.answers submission guidelines
  5. Supersedes: <news-answers/guidelines_762262746@rtfm.mit.edu>
  6. Followup-To: poster
  7. Date: 29 Mar 1994 10:24:33 GMT
  8. Organization: OpenVision Technologies, Inc.
  9. Lines: 811
  10. Approved: news-answers-request@MIT.Edu
  11. Distribution: world
  12. Expires: 12 May 1994 09:45:43 GMT
  13. Message-ID: <news-answers/guidelines_764934343@rtfm.mit.edu>
  14. Reply-To: news-answers-request@MIT.Edu (the *.answers moderation team)
  15. NNTP-Posting-Host: bloom-picayune.mit.edu
  16. Originator: jik@bloom-picayune.MIT.EDU
  17. Xref: bloom-beacon.mit.edu news.answers:16971 alt.answers:2256 comp.answers:4339 de.answers:50 misc.answers:516 rec.answers:4662 sci.answers:1020 soc.answers:1009 talk.answers:185
  18.  
  19. Archive-name: news-answers/guidelines
  20. Version: $Id: guidelines,v 1.96 94/03/21 05:08:22 lcb Exp $
  21.  
  22.  
  23. In order to submit an FAQ posting to the news.answers newsgroup (and
  24. to zero or more of the other *.answers newsgroups (alt.answers,
  25. comp.answers, de.answers, misc.answers, rec.answers, sci.answers,
  26. soc.answers, talk.answers) along with it), you should first modify the
  27. header of your posting to conform to the guidelines given below, in 
  28. section I.  Then, you should submit your posting to us using the 
  29. instructions given below, in section II.
  30.  
  31. Once your posting is approved, you will post it directly to
  32. news.answers and other newsgroups yourself; i.e., after approval, you
  33. no longer have to go through us at all to post.  This is explained in
  34. more detail below.
  35.  
  36.  
  37. I. Submission guidelines
  38.  
  39.  A. Why the guidelines?
  40.  
  41.     There are three main reasons for the guidelines:
  42.  
  43.   1. Appropriateness
  44.  
  45.      Only periodic informational postings that are intended to be read
  46.      by people belong in news.answers.  The guidelines are meant to
  47.      prevent other types of postings, including discussion of periodic
  48.      informational postings, from appearing in the group.
  49.  
  50.   2. Usefulness to people
  51.  
  52.      The newsgroup should be as useful as possible to the people who
  53.      read it.  Requirements such as effective "Subject:" and
  54.      "Summary:" lines (see below) further this goal.
  55.  
  56.   3. Automatic archiving
  57.  
  58.      One of the main points of news.answers is that it can be archived
  59.      automatically in order to build up a database of periodic
  60.      informational postings.  Requirements such as the "Archive-name:"
  61.      line further that goal.
  62.  
  63.  B. What the guidelines DON'T specify
  64.  
  65.     These guidelines DO NOT specify a specific, required format for
  66.     the bodies of FAQ postings.  Postings in *.answers are not
  67.     required to adhere to "Digest Message Format" format (Internet RFC
  68.     1153), or MIME (RFC 1341), or HTML, or SGML, or any other text
  69.     format, standard or otherwise.
  70.  
  71.     This omission is intentional.  Forcing all *.answers postings to
  72.     adhere to a specific format would dissuade many FAQ maintainers
  73.     from submitting their postings to *.answers.  Such a result would
  74.     be in direct contradiction to the chartered purpose of *.answers;
  75.     therefore, FAQ maintainers are free to choose whatever format they
  76.     want (assuming that it is human-readable) for the bodies of their
  77.     postings.
  78.  
  79.     These guidelines also DO NOT specify lower or upper limits for the
  80.     size of an acceptable FAQ posting.  However, a pragmatic lower limit
  81.     is set by the requirement that the articles be useful to people.  As
  82.     for a pragmatic upper limit, FAQ maintainers may wish to consider
  83.     that some part of their audience may not be able to access very
  84.     large articles at their sites due to intermediary software problems
  85.     (64KB is a common magic number), so postings larger than that may
  86.     not be able to be read by many people.
  87.  
  88.  C. Required header fields
  89.  
  90.     There are two "headers" in a news.answers posting.  The first is
  91.     the normal header that any article posted to the USENET has.  The
  92.     second header, the "auxiliary header," is separated from the first
  93.     by one or more blank lines.  As far as the News software is
  94.     concerned, the auxiliary header is just part of the body of the
  95.     article; however, news.answers requires some information in it.
  96.  
  97.     The requirements for each of the two headers are discussed in
  98.     detail below.  Required headers are marked with "(Required)",
  99.     while optional ones are marked with "(Optional)".
  100.  
  101.   1. The normal header
  102.  
  103.    a. Newsgroups (Required)
  104.  
  105.       We need to know exactly what will appear in the Newsgroups line
  106.       of the posting.
  107.  
  108.       In addition to news.answers, your posting should be cross-posted
  109.       to the other *.answers newsgroups of hierarchies in which it is
  110.       posted.  For example, a posting that is normally posted in both
  111.       rec.music.makers.synth and comp.sys.ibm.pc.soundcard should be
  112.       posted to both rec.answers and comp.answers in addition to
  113.       news.answers.  Note that postings to any of the *.answers
  114.       newsgroups MUST be posted in news.answers, regardless of what
  115.       other *.answers newsgroups they also appear in.
  116.  
  117.       Although the order of newsgroups on the line is not important
  118.       from the point of view of the news software, we prefer to have
  119.       news.answers listed last.  The other *.answers newsgroups should
  120.       be listed directly before news.answers.  Listing the primary
  121.       newsgroup(s) first improves the accuracy of newsgroup volume
  122.       statistics, provides better key information for index lists
  123.       and catalogues, and minimizes accidental postings to the
  124.       *.answers newsgroups from buggy newsreaders.
  125.  
  126.       Example:
  127.  
  128.        Newsgroups: comp.sys.foo,comp.answers,news.answers
  129.  
  130.       Note that your Newsgroups line should NOT contain only *.answers
  131.       groups.  FAQ postings should be cross-posted to *.answers from
  132.       their home newsgroups, rather than being posted separately to
  133.       *.answers.
  134.  
  135.       However, if you get approval for *.answers cross-posting in the
  136.       middle of your "posting cycle," and you do not wish to wait
  137.       until the next scheduled posting time to cross-post to
  138.       *.answers, then you can post your FAQ only to *.answers.  If you
  139.       choose to do this, please make sure to let us know you are going
  140.       to, and please do not do it more than once.
  141.  
  142.    b. Subject (Required)
  143.  
  144.       The subject line of your posting should have some meaning
  145.       outside of its home newsgroup(s).  For example, instead of just
  146.       "FAQ," you might have "<x> FAQ", where "<x>" is the name of the
  147.       newsgroup or the topic being discussed.
  148.  
  149.       Furthermore, important information should appear near the
  150.       beginning of the subject line, so that news readers that display
  151.       article summaries don't cut off the important information.  For
  152.       example, instead of "Frequently Asked Questions about <x>," use
  153.       "<x> Frequently asked Questions."
  154.  
  155.       For postings which are being split into multiple parts, you
  156.       should indicate in each posting's Subject line which part that
  157.       particular posting is, and how many parts total there are.  For
  158.       this purpose, simple Arabic numberals is prefered over Roman
  159.       numerals because Arabic numberals are more easily sorted and
  160.       manipulated by software.
  161.  
  162.       Example:
  163.  
  164.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 1/2
  165.        Subject: comp.sys.foo Frequently Asked Questions (FAQ), Part 2/2
  166.  
  167.    c. Followup-To (Required) and Reply-To (Optional)
  168.  
  169.       Your posting must have a "Followup-To:" line in the header that
  170.       directs followups to somewhere other than *.answers.  You may
  171.       choose to direct followups back to the home newsgroup(s) of the
  172.       FAQ, or to direct followups to the author of the FAQ, in which
  173.       case "Followup-To: poster" is sufficient.  That means that you
  174.       actually put the word "poster" there, as specified in the RFC
  175.       which describes the format of Usenet postings.  Do NOT put an
  176.       E-mail address in the "Followup-To:" field.
  177.  
  178.       If you forget the "Followup-To:" and we get mailed followups to
  179.       your FAQ, we're going to get peeved at you.
  180.  
  181.       Furthermore, your posting must have a valid E-mail reply address
  182.       in the header, either in the "From:" field, or if not in "From:"
  183.       then in "Reply-To:".
  184.  
  185.       Example:
  186.  
  187.        From: guru@foosys.com (Joe R. Programmer)
  188.        Followup-To: comp.sys.foo
  189.        Reply-To: faq-mail@foosys.com (FAQ Comments address)
  190.  
  191.       In this example, "guru" apparently wants mail about the FAQ to
  192.       go to a different address than the rest of his mail.  We've
  193.       shown the "From:" header, because the version of the FAQ that
  194.       you forward to us should show the "From:" header just as it will
  195.       appear when the article is actually posted.
  196.  
  197.    d. Supersedes, Expires, References (Optional)
  198.  
  199.       It is a good idea to use "Supersedes:" and "Expires:" header
  200.       lines to make sure that each version of your FAQ stays around
  201.       until the next time it is posted.  A useful tool for this is the
  202.       Perl FAQ poster written by Jonathan Kamens.  It is available
  203.       from rtfm.mit.edu, via anonymous ftp in the file
  204.       /pub/post_faq/post_faq.shar, or via mail server (send mail to
  205.       mail-server@rtfm.mit.edu with "send post_faq/post_faq.shar" in
  206.       the body).
  207.  
  208.       Post_faq takes an article with its static headers (i.e., the
  209.       headers that don't change each time the article is posted)
  210.       included, adds dynamic headers to it, and posts the article.
  211.       Another utility, Ian Kluft's AUTO-FAQ package (which is also
  212.       written in Perl) provides more functionality, including
  213.       automatic splitting of large FAQs into multi-part postings.  If
  214.       you're looking for something with a high level of automation to
  215.       assist you in your FAQ maintenance and posting, you might want
  216.       to try AUTO-FAQ instead of post_faq.  It's available via
  217.       anonymous ftp in ftp.amdahl.com:pub/faq/auto-faq.shar.Z.
  218.  
  219.       Furthermore, if you are posting a multi-part FAQ posting or a
  220.       series of related FAQ postings, it is a good idea to add a
  221.       "References:" line to all of the postings except the first one,
  222.       making the contents of that line the Message-ID of the first
  223.       posting in the series.  If you do this, then people who use
  224.       threaded news readers will be able to manipulate the entire
  225.       series as a single thread, including (for example) killing the
  226.       entire thread if they're not interested or saving the entire
  227.       thread to a file with one command.  The perl FAQ poster
  228.       mentioned above supports an option for doing this.
  229.  
  230.       Example:
  231.  
  232.        Expires: Fri, 1 May 1992 00:00:00 GMT
  233.        Supersedes: <foo-faq_701650000@foosys.com>
  234.  
  235.       The date in the "Expires:" header should be far enough into the
  236.       future that a new version of the FAQ will be posted before the
  237.       one you're posting now expires.  We've shown both headers in the
  238.       format the post_faq script would use.  We haven't shown a
  239.       "References:" header, since the example posting we've been
  240.       presenting is not part of a multi-part FAQ; if there were a
  241.       "References:" header, it would contain a Message ID just like
  242.       the "Supersedes:" header.
  243.  
  244.    e. Summary (Optional)
  245.  
  246.       You are encouraged to put a summary of the contents of your
  247.       article in the Summary field of the header.  Try to describe
  248.       what your FAQ discusses, and aim your description at someone who
  249.       may not actually be directly interested in the topic covered by
  250.       your FAQ.  There have been discussions about using the Summary
  251.       fields of the FAQ postings in news.answers to construct a short
  252.       "catalog" of the information available through news.answers, so
  253.       think of the Summary field as a "catalog entry" for your FAQ.
  254.  
  255.       Note that header fields (except for the Newsgroups field) are
  256.       allowed to span multiple lines, as long as the continuation
  257.       lines after the first start with whitespace (at least one space
  258.       or tab character).
  259.  
  260.       Example:
  261.  
  262.        Summary: This posting contains a list of Frequently Asked
  263.                Questions (and their answers) about Foo computers.  It
  264.                should be read by anyone who wishes to post to the
  265.                comp.sys.foo newsgroup.
  266.  
  267.   2. The auxiliary header
  268.  
  269.      The auxiliary header looks like the main message header (i.e.
  270.      "Field-name: field-value"), but is separated from the main
  271.      message header by a blank line, as well as followed by a blank
  272.      line separating it from the rest of the body of the message.
  273.  
  274.      The auxiliary header of this posting is:
  275.  
  276.       Archive-name: news-answers/guidelines
  277.       Version: $Id: guidelines,v 1.96 94/03/21 05:08:22 lcb Exp $
  278.  
  279.    a. Archive-name (Required)
  280.  
  281.       In order to be cross-posted in news.answers, your posting must
  282.       include an auxiliary archival header with an "Archive-name:"
  283.       field.
  284.  
  285.       The purpose of the archive name is two-fold.  First of all, it
  286.       specifies where the FAQ should be stored in archives of the
  287.       news.answers newsgroup.  Second, it should give people, even
  288.       people who do not read the home newsgroup of the FAQ, a pretty
  289.       good idea of what's in it.  Therefore, abbreviations which will
  290.       only be recognized by people already familiar with the topic
  291.       covered by the FAQ should be avoided if possible.
  292.  
  293.       The archive name should be composed of one or more one-word
  294.       (i.e., no spaces) components, separated by slashes.  Each
  295.       component should be 14 characters or less in length, if
  296.       possible, but this is not a strict requirement; if 14 characters
  297.       isn't enough, then each component should be unique in the first
  298.       14 characters (i.e., two archive names should never be identical
  299.       after their components are all truncated to 14 characters).
  300.       Avoid periods in the archive name, because some operating
  301.       systems choke on them; if you must have word separators, use
  302.       hyphens or underscores rather than periods.
  303.  
  304.       The archive namespace is hierarchical; for example, there are a
  305.       number of lists of bookstores in the "books/stores" directory of
  306.       the namespace, and all of their archive names start with
  307.       "books/stores/".  Avoid using slashes in your archive name
  308.       unless you are taking advantage of the hierarchical nature of
  309.       the namespace, i.e., unless you have multiple related FAQ
  310.       postings which should appear in a single directory in the
  311.       archive namespace.
  312.  
  313.       Multi-part FAQs should be named "name/part1", "name/part2", etc.
  314.       Alternatively, if the parts of the FAQ are split by topic rather
  315.       than by size, then you can use short topic names rather than
  316.       "part1", "part2", etc.
  317.  
  318.       If you post a diff for your FAQ, it should be named "name/diff".
  319.       If you post multiple diffs for a multi-part FAQ, they should be
  320.       named "name/diff1", "name/diff2", etc. (if you want to use just
  321.       one diff for a multi-part FAQ, you can just use "name/diff" as
  322.       its name).  If you post a diff to a one-part posting, then the
  323.       original FAQ should be named "name/part1" (or "name/faq", or
  324.       whatever else you think is appropriate, as long as we approve
  325.       it) and the diff should be named "name/diff".
  326.  
  327.       Consider these examples:
  328.  
  329.         Topic                                   Archive name(s)
  330.         -----------------------------------     ------------------------------
  331.         comp.ai FAQ                             ai-faq/part1
  332.                                                 ai-faq/part2
  333.                                                 ai-faq/part3
  334.         rec.travel.air FAQs, various topics     air-travel/bucket-shops
  335.                                                 air-travel/cheap-tickets/part1
  336.                                                 air-travel/cheap-tickets/part2
  337.                                                 air-travel/faq
  338.                                                 air-travel/jetlag-prevention
  339.                                                 air-travel/na-airport-codes
  340.                                                 air-travel/world-airport-codes
  341.         soc.culture.esperanto FAQ               esperanto-faq
  342.  
  343.       Please pick the archive name that you would like to use for your
  344.       posting, and include the "Archive-name:" line with that archive
  345.       name in it, when submitting to news.answers.  If there is some
  346.       problem with it, or if we would like to suggest an alternate
  347.       name, we will let you know.
  348.  
  349.       Example:
  350.  
  351.        Archive-name: foo-faq
  352.  
  353.       If your posting already has an "Archive-name:" line which is not
  354.       a valid news.answers archive name and you do not want to change
  355.       it, or if you want the "Archive-name:" line you add to contain
  356.       the name of a file in your own archives rather than in the
  357.       news.answers archives, you can use a
  358.       "News-answers-archive-name:" header line instead.
  359.  
  360.    b. Other archive names (Optional)
  361.  
  362.       The software which builds the FAQ archive on rtfm.mit.edu (see
  363.       the "Introduction to the *.answers newsgroups" posting for more
  364.       information about it) automatically uses the "Archive-name:"
  365.       line to determine the file name in which to save an FAQ, when
  366.       saving it in any of the "answers" newsgroups (news.answers,
  367.       rec.aviation.answers, etc.).
  368.  
  369.       Furthermore, if you have a field of the form
  370.       "Newsgroup-name-archive-name: name" in your FAQ's auxiliary
  371.       header (see the example below), the specified archive name will
  372.       be used to save in the specified newsgroup.  Such a
  373.       newsgroup-specific archive name overrides any generic
  374.       "Archive-name:" line.
  375.  
  376.       When an archive name for an FAQ cannot be determined in either
  377.       of the ways mentioned above, the Subject line of the posting
  378.       (with some minor modifications) is used as its file name.
  379.  
  380.       For example, if you have this in your normal header:
  381.  
  382.        Newsgroups: comp.foo,comp.bar,comp.answers,news.answers
  383.        Subject: Comp.foo FAQ
  384.  
  385.       and this in your auxiliary header:
  386.  
  387.        Archive-name: foo-faq
  388.        Comp-bar-archive-name: bar-faq
  389.  
  390.       then the posting will be saved as "foo-faq" in comp.answers and
  391.       news.answers (because they are both "answers" newsgroups and
  392.       will therefore use the Archive-name line), as "bar-faq" in
  393.       comp.bar, and as "Comp.foo_FAQ" in comp.foo.
  394.  
  395.       If you do decide to specify additional archive names in your
  396.       posting, please obey the guidelines for archive names given
  397.       above.
  398.  
  399.    c. Posting-Frequency (Optional)
  400.  
  401.       A "Posting-Frequency" field in the auxiliary header can give
  402.       the reader a good idea of how often your FAQ is posted, for example
  403.       "every 14 days" or "monthly" (see section D, below).
  404.  
  405.       Example:
  406.  
  407.        Posting-Frequency: monthly
  408.  
  409.       If you specify this field, it will be automatically copied into
  410.       the "List of Periodic Informational Postings".
  411.  
  412.    d. Last-modified, Version (Optional)
  413.  
  414.       You can have other fields in the auxiliary header, if you want.
  415.       Two common ones are "Last-modified:" and "Version:".
  416.  
  417.       Example:
  418.  
  419.        Last-modified: 1992/03/25
  420.        Version: 2.5
  421.       
  422.   3. Sample FAQ headers
  423.  
  424.      Putting together the examples We've given above, your FAQ's
  425.      headers (or, at least, the ones you submit to us) might look like
  426.      this:
  427.  
  428.      From: guru@foosys.com (Joe R. Programmer)
  429.      Newsgroups: comp.sys.foo,comp.answers,news.answers
  430.      Subject: comp.sys.foo FAQ
  431.      Followup-To: comp.sys.foo
  432.      Reply-To: faq-mail@foosys.com (FAQ Comments address)
  433.      Summary: This posting contains a list of Frequently Asked
  434.              Questions (and their answers) about Foo computers.  It
  435.              should be read by anyone who wishes to post to the
  436.              comp.sys.foo newsgroup.
  437.      Expires: Fri, 1 May 1992 00:00:00 GMT
  438.      Supersedes: <foo-faq_701650000@foosys.com>
  439.  
  440.      Archive-name: foo-faq
  441.      Posting-Frequency: monthly
  442.      Last-modified: 1992/03/25
  443.      Version: 2.5
  444.  
  445.      Note that the blank line separating the normal header from the
  446.      auxiliary header must be completely blank, i.e., no tabs or
  447.      spaces, and that there must also be one or more completely blank
  448.      lines after the auxiliary header.
  449.  
  450.      Of course, you can include in the posting header any of the other
  451.      standard USENET header fields that have not been discussed here.
  452.  
  453.  D. Posting frequency
  454.  
  455.     The frequency at which you choose to post your FAQ is left to your
  456.     discretion.  Some FAQ maintainers find that a monthly posting,
  457.     with an Expires header to prevent each posting from going away
  458.     before its replacement is posted, is sufficient.  Some other
  459.     newsgroups are so busy that a weekly posting of the FAQ is needed.
  460.     Another possibility is to post the complete FAQ relatively
  461.     infrequently, while posting a shorter pointer to it (e.g.,
  462.     providing instructions for getting it from archives) more
  463.     frequently.
  464.  
  465.     If you choose to post your FAQ more frequently than once per
  466.     month, you might want to consider not cross-posting it to
  467.     *.answers every time you post.  Although it may be necessary to
  468.     post the FAQ in its home newsgroup often, it is probably not
  469.     necessary to post it in *.answers as frequently.
  470.  
  471.     Note, however, that if you do this, you can't use Supersedes every
  472.     time you post your FAQ, since a posting in just the FAQ's home
  473.     newsgroup should not supersede the posting in both the home
  474.     newsgroup and *.answers.  Therefore, unless you're willing to have
  475.     two copies of your FAQ in your home newsgroup at all times, you
  476.     should always cross-post to *.answers (or use the system mentioned
  477.     above, cross-posting the full FAQ to *.answers and a more frequent
  478.     pointer posting just in its home newsgroup).
  479.  
  480.     When submitting your FAQ, please be sure to let us know the
  481.     frequency at which you intend to post it to its home newsgroup, as
  482.     well as the frequency at which you intend to cross-post it to
  483.     *.answers (if different).  The best way for this is to put this
  484.     information into the "Posting-Frequency" field of the auxiliary
  485.     header.
  486.  
  487.  E. Mailing lists for FAQ maintainers
  488.  
  489.     Maintainers of FAQs are strongly urged to join the faq-maintainers
  490.     mailing list, which is used for discussion about the *.answers
  491.     newsgroups and the maintenance of USENET FAQs.
  492.  
  493.     If you don't want to be on the discussion list, you may wish to
  494.     join the faq-maintainers-announce list, which will be used only
  495.     for announcements, instead.  Note that subscribers to
  496.     faq-maintainers automatically receive messages sent to
  497.     faq-maintainers-announce.
  498.  
  499.     Traffic on faq-maintainers tends to come in bursts -- it averages
  500.     three to four messages per week, but during a burst there may be as
  501.     many as several dozen messages in a single day, and in between such
  502.     bursts, there may be weeks of no messages at all.
  503.  
  504.     Traffic on faq-maintainers is very, very low (e.g., it is not unheard
  505.     of for six months to pass with no messages sent to the list).
  506.  
  507.     When submitting your FAQ, make sure to let us know whether or not
  508.     you want to be on one of the lists.
  509.  
  510.  F. List of Periodic Informational Postings
  511.  
  512.     Unless you tell us otherwise, We will add any postings submitted
  513.     to *.answers to the "List of Periodic Informational Postings"
  514.     (LoPIP) articles which appear in news.answers, news.lists, and
  515.     news.announce.newusers.
  516.  
  517.     If you do not have copies of the LoPIP postings and would like to
  518.     get them, to see what they're like or to check if your FAQ is
  519.     already listed, see the instructions at the end of this message.
  520.  
  521.  G. Article approval
  522.  
  523.     Once all of the other issues listed in this posting are resolved,
  524.     you will be given approval to cross-post your FAQ to *.answers.
  525.     You will have to indicate in the header of your posting that such
  526.     approval has been given, or the posting will be mailed to us
  527.     instead of posted.
  528.  
  529.     Note that we are intentionally being somewhat vague about what
  530.     this entails.  When we approve your posting for *.answers, we will
  531.     provide more specific instructions.
  532.  
  533.  H. Checklist
  534.  
  535.     Following is a checklist for your *.answers submission.  Please
  536.     go through all the questions; if you answer "no" to any of
  537.     them, look at the relevant section of this article again, and
  538.     correct your submission accordingly.
  539.  
  540.     Does the posting have a message header?
  541.     Does the posting have a Newsgroups line?
  542.     Does the Newsgroups line contain other than *.answers
  543.         newsgroups?
  544.     Does the Newsgroups line contain news.answers?
  545.     Are the *.answers newsgroups listed last on the 
  546.         Newsgroups line?
  547.     Does the Newsgroups line contain all relevant *.answers
  548.         newsgroups?
  549.     Does the Newsgroups line contain inappropriate *.answers
  550.         newsgroups?
  551.     Does the posting have a Subject line?
  552.     Is the Subject line informative?
  553.     Is important information on the Subject line near the beginning
  554.         of the line?
  555.     Does the posting have a Followup-To line?
  556.     Does the Followup-To line point not point to any
  557.         *.answers newsgroups?
  558.     Does the posting have a From or Reply-To line with a valid address?
  559.     Does the posting have an Archive-name line?
  560.     Is the auxiliary header separated from the text by a blank line?
  561.     Is the auxiliary header separated from the main header by a blank
  562.         line?
  563.     Is the Archive-name line valid?
  564.     Have you told us the frequency of your posting?
  565.     Have you told us wether you want to be on faq-maintainers or
  566.         faq-maintainers-announce?
  567.  
  568. II. Submission instructions
  569.  
  570.    If you have a posting which you wish to submit to *.answers, you
  571.    should first read the guidelines listed above and modify your
  572.    posting to conform to them.  Then, you should submit it by posting
  573.    it to the news.answers newsgroup, assuming that the software on the
  574.    poster's site works properly and will forward the posting to the
  575.    news.answers moderator, or by mailing it to the news.answers
  576.    submission address, news-answers@MIT.Edu.  ONLY SUBMISSIONS SHOULD
  577.    BE MAILED TO THAT ADDRESS.  If there is some commentary or
  578.    explanation that needs to be made, it should be mailed in a
  579.    separate message to news-answers-request@MIT.Edu, which is the
  580.    moderator contact address for any *.answers-related business.
  581.  
  582.    If you post the FAQ to both *.answers and one or more other
  583.    moderated groups, you need separate approval from each of the
  584.    moderators.  Wait for approval from each of them (including us)
  585.    before actually posting.  In this case, you should send in the
  586.    FAQ to us via e-mail, because the submission will be sent via
  587.    e-mail to the first moderated group which appears in the
  588.    Newsgroup line.
  589.  
  590.    Please submit the FAQ in a form as close as possible to how it
  591.    appears when you post it normally.  This means that you should
  592.    include a complete header, with at the very least the Subject line
  593.    you normally use.  We very much prefer you actually posting the
  594.    message to news.answers as you would post it normally, including
  595.    the cross-posted newsgroups, but omitting the moderation approval
  596.    header line that would cause the article to actually be posted
  597.    rather than mailed to us; this way, we will get to see exactly how
  598.    the article will look when it is actually posted in news.answers.
  599.    Also, if your FAQ does not say somewhere near the top how often it
  600.    is posted, then please let us know the frequency in separate
  601.    E-mail.
  602.  
  603.    Note that if you do not indicate moderator approval in the header
  604.    of your posting, it will NOT be posted to any newsgroup, even if
  605.    you list other newsgroups on the Newsgroups line besides *.answers
  606.    groups.  Therefore, you CAN and SHOULD place all Newsgroups to
  607.    which you intend to post in the Newsgroups line, in the order you
  608.    intend them to be in when you post.
  609.  
  610.    We will respond, by agreeing that the FAQ belongs in *.answers
  611.    as-is, or by asking you to make minor modifications to it in order
  612.    to make it acceptable, or by rejecting it as inappropriate for
  613.    *.answers.  If you are asked to make modifications, please do so
  614.    and resubmit the posting to us just as you did the first time.
  615.  
  616.    We are all volunteers, doing *.answers moderation in our spare
  617.    time.  Therefore, we can't always process submissions and other
  618.    *.answers - related correspondence immediately.  Please don't
  619.    write to us asking whether we received your submission until at
  620.    least a week after you submitted it.
  621.  
  622.    Once an FAQ has been approved for *.answers, you will post it
  623.    directly to the group yourself, by indicating in the header of the
  624.    message that it was approved by the *.answers moderator, as
  625.    described above.
  626.  
  627.    If possible, try to avoid posting your FAQ at a "predictable"
  628.    time.  For example, if you have decided to post it monthly, don't
  629.    automatically decide to post it on the first of every month.  This
  630.    causes a flood of FAQs in *.answers (and on the net in general) at
  631.    certain times of months, and this flood is big enough to overwhelm
  632.    some smaller sites and many readers of *.answers.  Therefore,
  633.    rather than picking the "obvious" time to post, pick some other,
  634.    random time during the month to do your posting.
  635.  
  636.    If you have trouble posting your FAQ once it has been approved,
  637.    because your site won't let you post to a moderated newsgroup,
  638.    because you don't have good posting access, or because of any other
  639.    reason, feel free to get in touch with us and we'll try to help.
  640.    Alternatively, you can use the FAQ server which we run to help
  641.    solve such problems; you mail your FAQ or FAQs to it, and it posts
  642.    them periodically automatically.  For more information about the
  643.    FAQ server, send mail to faq-server@rtfm.mit.edu with "help"
  644.    (without the quotes) in the Subject of your message.
  645.  
  646.  
  647. III. Once your posting is approved
  648.  
  649.    The following is a list of some situations which might occur after
  650.    your FAQ has been approved for *.answers, and what you need to do
  651.    for each one.
  652.  
  653.    A. Transfer an FAQ to a new maintainer
  654.  
  655.       The old maintainer should inform news-answers-request@mit.edu of
  656.       the change in maintainers.  The new maintainer should read this
  657.       document (i.e., the "*.answers submission guidelines") and
  658.       inform news-answers-request@mit.edu that he has done so.
  659.       Furthermore, the new maintainer should resubmit the FAQ if he
  660.       intends to make any header changes other than changing the From
  661.       and/or Reply-To lines.  The new maintainer should wait for
  662.       approval before posting.
  663.  
  664.    B. Change an FAQ's posting frequency
  665.  
  666.       Inform news-answers-request@mit.edu of the new frequency, unless
  667.       you have a "Posting-Frequency" field in your auxiliary header;
  668.       in that case, just change that field.
  669.  
  670.    C. Change an FAQ's header(s)
  671.  
  672.       1. Subject line
  673.  
  674.      Inform news-answers-request@mit.edu of the new Subject line,
  675.      or resubmit the entire FAQ to news-answers@mit.edu, and wait
  676.      for approval before posting.
  677.  
  678.       2. Newsgroups line
  679.  
  680.      Inform news-answers-request@mit.edu of the new Newsgroups
  681.      line, or resubmit the entire FAQ to news-answers@mit.edu, and
  682.      wait for approval before posting.
  683.  
  684.       3. From line, without changing maintainers
  685.  
  686.      If the new From line obviously refers to the same individual
  687.      as the old one, you don't have to do anything.  If it's not
  688.      obvious that the new From line refers to the same individual,
  689.      inform news-answers-request@mit.edu and wait for approval
  690.      before posting.
  691.  
  692.       4. Archive-name line
  693.  
  694.      Inform news-answers-request@mit.edu and wait for approval
  695.      before posting.
  696.  
  697.       5. Followup-To line
  698.  
  699.          As long as it exists and doesn't contain any *.answers
  700.      newsgroups in it, you don't have to do anything.
  701.  
  702.       6. Other headers
  703.  
  704.          As long as you don't change the overall structure of your
  705.      headers (e.g., make sure you keep an auxiliary header with
  706.      the Archive-name line in it), you don't have to do anything
  707.      about changes to other headers.
  708.  
  709.    D. Add postings to or delete postings from an FAQ
  710.  
  711.       1. Add a new part to a multi-part FAQ
  712.  
  713.      Submit the new part to news-answers@mit.edu, or inform
  714.      news-answers-request@mit.edu if the new part's headers are
  715.      consistent with the other parts (e.g., if your Subject lines
  716.      are in the form "foo FAQ part * of *" and your archive names
  717.      look like "foo-faq/part*", and you add a new part which looks
  718.      just like the others except for a new part number, you don't
  719.      have to resubmit the new part or resubmit all the other parts
  720.      because you changed the "of *" number in their Subject
  721.      lines).  Wait for approval before posting.
  722.  
  723.       2. Add a diff posting
  724.  
  725.          Submit it to news-answers@mit.edu.  If you already have a
  726.          multi-part FAQ, choose the archive name to be consistent with
  727.          the other ones. If your  archive names look like "foo-faq/part*",
  728.          the diff posting should have the archive name "foo-faq/diff".  If
  729.          your FAQ had only one part before the change, add "/part1" to the
  730.          archive name (e.g. "foo-faq/part1"), and submit both the FAQ and
  731.      the diff posting.
  732.  
  733.       3. Split up a single-part FAQ
  734.  
  735.          Submit all the parts to news-answers@mit.edu, with archive names
  736.      in the format "foo-faq/part1", "foo-faq/part2", etc.
  737.  
  738.       4. Delete a part from a multi-part FAQ
  739.  
  740.      Inform news-answers-request@mit.edu.  Wait for approval
  741.      before posting.
  742.  
  743.       5. Terminate an FAQ (i.e., stop posting it forever)
  744.  
  745.          Inform news-answers-request@mit.edu.
  746.  
  747.    E. Create a new FAQ
  748.  
  749.       Submit it to *.answers following the guidelines in sections I
  750.       and II above, just like you submitted your previous FAQ(s).
  751.  
  752.  
  753. IV. This posting
  754.  
  755.    Comments about, suggestions about or corrections to this posting
  756.    are welcomed.  If you would like to ask us to change this posting
  757.    in some way, the method we appreciate most is for you to actually
  758.    make the desired modifications to a copy of the posting, and then
  759.    to send us the modified posting, or a context diff between the
  760.    posted version and your modified version (if you do the latter,
  761.    make sure to include in your mail the "Version:" line from the
  762.    posted version).  Submitting changes in this way makes dealing with
  763.    them easier for us and helps to avoid misunderstandings about what
  764.    you are suggesting.
  765.  
  766.    The following people provided feedback and helped to make this
  767.    posting more readable and useful:
  768.  
  769.      Stan Brown <brown@NCoast.ORG>
  770.      L. Detweiler <ld231782@longs.lance.colostate.edu>
  771.      Aydin Edguer <edguer@alpha.CES.CWRU.Edu>
  772.      Mark Eckenwiler <eck@panix.com>
  773.      Tom_Lane@G.GP.CS.CMU.EDU
  774.      Cindy Tittle Moore <tittle@ics.uci.edu> 
  775.      Steven D. Ourada <sourada@iastate.edu>
  776.      Edward Reid <ed@titipu.resun.com>
  777.      Ken Shirriff <shirriff@sprite.Berkeley.EDU>
  778.      Dan Tilque <dant@logos.WR.TEK.COM>
  779.      Bill Wohler <wohler@sap-ag.de>
  780.  
  781.  
  782. V. Getting the "List of Periodic Informational Postings"
  783.  
  784.    There are seven "List of Periodic Informational Postings"
  785.    postings:
  786.  
  787.     Subject: List of Periodic Informational Postings, Part 1/7
  788.     Subject: List of Periodic Informational Postings, Part 2/7
  789.     Subject: List of Periodic Informational Postings, Part 3/7
  790.     Subject: List of Periodic Informational Postings, Part 4/7
  791.     Subject: List of Periodic Informational Postings, Part 5/7
  792.     Subject: List of Periodic Informational Postings, Part 6/7
  793.     Subject: List of Periodic Informational Postings, Part 7/7
  794.     Newsgroups: news.lists,news.announce.newusers,news.answers
  795.  
  796.    They are available in the indicated USENET newsgroups, or via
  797.    anonymous ftp from rtfm.mit.edu (18.70.0.209) in the files:
  798.  
  799.     /pub/usenet/news.answers/periodic-postings/part1
  800.     /pub/usenet/news.answers/periodic-postings/part2
  801.     /pub/usenet/news.answers/periodic-postings/part3
  802.     /pub/usenet/news.answers/periodic-postings/part4
  803.     /pub/usenet/news.answers/periodic-postings/part5
  804.     /pub/usenet/news.answers/periodic-postings/part6
  805.     /pub/usenet/news.answers/periodic-postings/part7
  806.  
  807.    They are also available from mail-server@rtfm.mit.edu by sending a
  808.    mail message containing any or all of:
  809.  
  810.     send usenet/news.answers/periodic-postings/part1
  811.     send usenet/news.answers/periodic-postings/part2
  812.     send usenet/news.answers/periodic-postings/part3
  813.     send usenet/news.answers/periodic-postings/part4
  814.     send usenet/news.answers/periodic-postings/part5
  815.     send usenet/news.answers/periodic-postings/part6
  816.     send usenet/news.answers/periodic-postings/part7
  817.  
  818.    If you want to find out more about the mail server, send a message
  819.    to it containing "help".
  820.  
  821. -- 
  822.         pshuang@mit.edu (Ping Huang)
  823.         jik@cam.ov.com (Jonathan I. Kamens)
  824.         ig25@rz.uni-karlsruhe.de (Thomas Koenig)
  825.         buglady@bronze.lcs.mit.edu (Aliza R. Panitz)
  826.         pschleck@unomaha.edu (Paul W. Schleck)
  827.  
  828.             -- the *.answers moderation team
  829.  
  830.